Developer --> Technical Publications
PATHMac OS 8 Developer Documentation > Files > Navigation Services >

Programming With Navigation Services 1.1

Identifying Navigation Services Availability

You should always use these functions to test for Navigation Services availability and features. Navigation Services is a shared library, so calling the Gestalt function does not reveal whether it is running.


NavServicesAvailable

Determines whether the Navigation Services library is available on the user's system.

Boolean NavServicesAvailable (void);
function result
A Boolean value. This function returns true if Navigation Services is available, false if not.

DISCUSSION

Use this function before attempting to use Navigation Services.

SPECIAL CONSIDERATIONS

There is a known problem with Navigation Services 1.0 that occurs if you call NavServicesAvailable more than once without the Appearance Manager being installed. Make sure that you check for the presence of the Appearance Manager before calling NavServicesAvailable .


NavLibraryVersion

Reports the currently installed version of the Navigation Services shared library.

UInt32 NavLibraryVersion (void);
function result
An unsigned 32-bit integer. This value represents the version number (in binary-coded decimal) of Navigation Services installed on the user's system.

DISCUSSION

If you need to use Navigation Services features that are present only in version 1.1, use this function to determine which version of Navigation Services is installed.

© 1998 Apple Computer, Inc. – (Last Updated 23 Nov 98)

Previous | Back Up One Level | Next |